A slew of doc edits to increase product linkage.
authorrobertl <robertl>
Sat, 18 Nov 2006 07:14:41 +0000 (07:14 +0000)
committerrobertl <robertl>
Sat, 18 Nov 2006 07:14:41 +0000 (07:14 +0000)
32 files changed:
xmldoc/formats/arc.xml
xmldoc/formats/coastexp.xml
xmldoc/formats/cst.xml
xmldoc/formats/csv.xml
xmldoc/formats/fugawi.xml
xmldoc/formats/gcdb.xml
xmldoc/formats/gdb.xml
xmldoc/formats/geo.xml
xmldoc/formats/glogbook.xml
xmldoc/formats/google.xml
xmldoc/formats/gpilots.xml
xmldoc/formats/gpsutil.xml
xmldoc/formats/gpx.xml
xmldoc/formats/holux.xml
xmldoc/formats/kml.xml
xmldoc/formats/lowranceusr.xml
xmldoc/formats/magellan.xml
xmldoc/formats/magellan1.xml
xmldoc/formats/magellanx.xml
xmldoc/formats/maggeo.xml
xmldoc/formats/magnav.xml
xmldoc/formats/mapsend.xml
xmldoc/formats/nmea.xml
xmldoc/formats/options/tpg-datum.xml
xmldoc/formats/pcx.xml
xmldoc/formats/s_and_t.xml
xmldoc/formats/saplus.xml
xmldoc/formats/tmpro.xml
xmldoc/formats/tomtom.xml
xmldoc/formats/xmap.xml
xmldoc/formats/xmap2006.xml
xmldoc/formats/xmapwpt.xml

index a10c27ad1ab89a0e7e110f63549444a86c2600cb..4365cce2812a5cfe7037d85cd0ce4773f5c8aa67 100644 (file)
@@ -4,3 +4,11 @@ This format is used by GPSBabel itself as the input to the
 <link linkend="filter_polygon">polygon</link> filters.  See those filters
 for more information.
 </para>
+<para>
+The arc format reads two numeric fields, a latitude and a longitude, 
+in any format recognized as <link linkend="style_def_lathuman">human 
+readable</link> and writes as simple degrees decimal.  It really is
+intended for GPSBabel's own internal use more than general use, though
+it turns out to be a convenient way of expressing simple polylines and 
+polygons.
+</para>
index 066e29fcfb384d56ebc34a85803677398315511a..3356a9fff4c1c58d62d8e2733edf366d47ad1987 100644 (file)
@@ -1,7 +1,7 @@
 
       
       
-      <para>This is the format used by CoastalExplorer (tm). The
+      <para>This is the format used by <productname>CoastalExplorer</productname>. The
 format is XML with items uniquely identified by Windows-style UUIDs.
 <ulink url="http://www.rosepointnav.com">http://www.rosepointnav.com</ulink>
          </para>
index 835c162d1598532a924adac536d8889650a70418..85890bad8ea825811dfb6ae1ec4076bbb9ff5e42 100644 (file)
@@ -2,7 +2,7 @@
       
       
       <para> With this format we can read  <ulink url="http://phgiraud.free.fr/CarteSurTable/CarteSurTable.htm">CarteSurTable</ulink>data files.
- <ulink url="http://phgiraud.free.fr/CarteSurTable/CarteSurTable.htm">CarteSurTable</ulink>is a shareware program widely used in France. The data
+ <ulink url="http://phgiraud.free.fr/CarteSurTable/CarteSurTable.htm">CarteSurTable</ulink> is a shareware program widely used in France. The data
 inside have to be seen as a mixture of a waypoints list, one route and
 several tracks.  
          </para>
index 46f6f68d46ddbf5306af71641688572a5476309f..3b2e1112cad2852aac140154fcf1f9dc7df23c44 100644 (file)
@@ -2,7 +2,7 @@
       
       
       <para> There are a billion variants of Comma Separated Value
-data.  This is the one that makes <ulink url="http://www.delorme.com">Delorme"</ulink> <productname>S&amp;A Deluxe 9</productname> happy. It's
+data.  This is the one that makes <ulink url="http://www.delorme.com">Delorme</ulink> <productname>S&amp;A Deluxe 9</productname> happy. It's
 also a very simple program and useful for many other programs like
 spreadsheets.</para>
       <para> CSV is also the correct format for 
@@ -10,4 +10,11 @@ spreadsheets.</para>
 their commercial mapping program, or GDM6 (their free waypoint
 manager) for iFinder which is available at <ulink url="http://www.lowrance.com/Software/GDM6/Default.asp">lowrance.com</ulink>
          </para>
-    
+    <para>
+       On write, this format writes simple "latitude, longitude" pairs, but 
+on read it  will read anything supported by our <link linkend="style_def_lathuman">human readable</link> definition.
+    </para>
+    <para>
+       For something-separated data that has headers identifying the various
+       fields, see our <link linkend="fmt_unicsv">universal csv</link> format.
+    </para>
index 8975401a832a3607842f39b5c5ccb96c8123e4f0..51b819f797b48ec8483b0d6294e395445c1ba7c9 100644 (file)
@@ -1,7 +1,7 @@
 
       
       
-      <para> This was a requested CSV format, *not* the proprietary
+      <para> This was a requested <link linkend="fmt_csv">CSV format</link>, and is <emphasis>not</emphasis> the proprietary
 binary format used by <ulink url="http://www.fugawi.com">Fugawi</ulink>. Like any other CSV format, GPSBabel
 cannot read tracks in this format, but converting a track into it and
 then importing as track in Fugawi works.</para>
index 6e7408429863d2fa4eb5511f959f79620736d8fe..d9e1d4d53ef0eae98464f724b2b54b8ed355fdc7 100644 (file)
@@ -1,7 +1,7 @@
       
       <para>This is format for the 
 <ulink url="http://vip.hyperusa.com/~dougs/geocachingdb/geocachingdb.htm">
-GeocachingDB</ulink>program by DougsBrat.  It works with v2
+GeocachingDB</ulink> program by DougsBrat.  It works with v2
 and v3 of this program. 
          </para>
     
index eb25c0b8b16de692b165fdaf16eaba9d134510cd..80788965ecd3119365ff7dcba54746b9a8488a98 100644 (file)
@@ -1,6 +1,7 @@
 <para> 
 Support for the "Garmin GPS Database" format used by
-default in MapSource versions since release 6.0. By default GPSBabel creates
+default in <productname>MapSource</productname> versions since release 6.0 of 
+that product. By default GPSBabel creates
 gdb files of version 2.  Version 2 is used in Mapsource 6.3 and 6.5.
 </para>
 <para> 
index 7cd659e09d84eaad0d804f913da0eb17c417be75..42c1b22a1bb335cb4cc594e93c68747204ecc642 100644 (file)
@@ -1,5 +1,5 @@
 <para>
-This format supports the Geocaching.com/EasyGPS ".loc" format.  This format
+This format supports the <ulink  url="http://www.geocaching.com">Geocaching.com</ulink>/<ulink url="http://www.easygps.com">EasyGPS</ulink> ".loc" format.  This format
 was created specifically for Geocaching.com and is not the same as the 
 standard EasyGPS .loc format.  See the <link linkend="fmt_easygps">EasyGPS</link> 
 or <link linkend="fmt_gpx">GPX</link> formats for more general EasyGPS support.
index c79db28f675e566be6a1f7ce8b1ea3328d78ce9d..bbaa7b02bdef289c0ffbfc3ff220ce6c1b561de2 100644 (file)
@@ -2,6 +2,10 @@
       
       
       <para>This is the XML format used by the Garmin Logbook product
-that ships with Forerunner and Foretrex.  <ulink url="http://www.garmin.com">http://www.garmin.com</ulink>
+that ships with Forerunner and Foretrex.  
+As of early 2006, this program is apparently  been discontinued in favor of
+<link  linkend="fmt_gtrnctr">Garmin Training Center</link>.
+
+See: <ulink url="http://www.garmin.com">http://www.garmin.com</ulink>  
          </para>
     
index f564951aeb5f4ccfd4fa589b48e40b93c7016b0e..d458c7cb1ffb213be2a510d23600ca09843f4d8a 100644 (file)
@@ -2,7 +2,7 @@
       
       
       <para> This format is designed to read the XML emitted when you
-tack "&amp;output=js" onto the end of a Google Maps route URL (use
+tack "&amp;output=js" onto the end of a <ulink url="http://www.maps.google.com>Google Maps">Google Maps</ulink>route URL (use
 the "link to this page" option to get a usable URL.)  This allows you
 to plan a route using Google Maps, then download it and use it in your
 own mapping program or GPS receiver.   To get a file suitable for use
index c3c9dd4509d2bbdb0d56b16a47ab8546d0e5d65a..ffb947cdd92073e25a44eed248e008f22c90b87b 100644 (file)
@@ -1,12 +1,10 @@
 
       
       
-      <para> This is a Palm/OS file format for GPilotS.  It was tested
-against version 6.2.
+      <para> This is a Palm/OS file format for 
+            <ulink url="http://www.cru.fr/perso/cc/GPilotS/">GPilotS</ulink>.
+       It was tested against version 6.2 of GPilotsS
 </para>
-      <para>
-            <ulink url="http://www.cru.fr/perso/cc/GPilotS/">http://www.cru.fr/perso/cc/GPilotS/</ulink>
-         </para>
       <para> Neither tracks nor routes are supported at this
 time.</para>
     
index 52f2f9237970e69cb1bbef8dd85ac4134fe2f7e5..d39bd8d790988ca01386d1f4aa68ab758a8c6842 100644 (file)
@@ -1,8 +1,12 @@
 
       
       
-      <para>GPSUtil has a simple file format of this program that runs
+      <para>The format we call <ulink url="http://www.cs.uakron.edu/~hennings/gpsutil">gpsutil</ulink> is a simple file format used by a program that runs
 on POSIX- compliant OSes like UNIX and Linux.  Reads and writes of
-this format are reliable.  (I've also contributed to this program.)
-It's available at <ulink url="http://www.cs.uakron.edu/~hennings/gpsutil">cs.uakron.edu</ulink>.</para>
+this format are very reliable.  (<ulink url="/people/robertlipe.html">The lead
+developer of GPSBabel</ulink> also contributed to this that 'gpsutil' 
+the early days.)</para>
+<para>
+       Note that 'gpsutil' is a different format - and program - than the one called <ulink url="http://www.gpsu.co.uk/index.html">GPS Utility</ulink>; for that one, you should probably use our  <link linkend="fmt_pcx">PCX module</link>.
+</para>
     
index 1af5de8d923e1a6d0db72a763088c607bd394cc0..9f68c0ae2e7c9bd6bbaf10d6cc24aa12f87babfa 100644 (file)
@@ -6,4 +6,9 @@ formats supplied.  It is described at <ulink url="http://www.topografix.com/gpx.
 supported by EasyGPS, ExpertGPS, and many other programs described at
 <ulink url="http://www.topografix.com/gpx_resources.asp">topografix.com</ulink>
          </para>
+       <para>
+       GPSBabel's reader of this module attempts to preserve tags it doesn't
+       really understand.   It also tries to glean interesting data from
+       <ulink url="http://www.geocaching.com">pocket queries from Geocaching.com</ulink>.
+       </para>
     
index be227fb38912aba2640d86c009cffe0a3cadc838..8524b14838ec640a80ec4bc1d6d0b20e93a814e1 100644 (file)
@@ -1,7 +1,7 @@
 
       
       
-      <para> The Holuxgm-100 (e-fox) gps receiver uses standard
+      <para> The Holux gm-100 (e-fox) gps receiver uses standard
 compact flash cards.  File formats were provided by Holux-Taiwan
 <ulink url="http://www.holux.com.tw">holux.com</ulink> to the author.
 The code was tested against version 2.27E1; other versions and
index a77c7238c75e1ed5cc2f850ac16ae46a52716481..b35632ba021dca0178cc2f098bd15ca2b285c9f9 100644 (file)
@@ -1,6 +1,6 @@
 <para> 
 KML, the Keyhole Markup Language, is used by Keyhole and
-Google Earth.  There are features in this file format that GPSBabel
+<ulink url="http://earth.google.com">Google Earth</ulink>.  There are features in this file format that GPSBabel
 doesn't support - such as camera views - but waypoints, tracks, and routes 
 work well.
 </para>
index 79a34410a2373b707544908309b60d4dfa9c5a4d..f2383eb912013acd08ce4cc9a162d5b120743bd7 100644 (file)
@@ -1,5 +1,5 @@
 <para> 
-The Lowrance iFinder GPS series has the unique capability
+The <ulink url="http://www.lowrance.com">Lowrance iFinder GPS</ulink> series has the unique capability
 to output its data to an MMC card.  The data is saved to the card as a
 .USR file and can be read by your computer using a card reader.
 Waypoints, routes, tracks are supported.  By default, Event marker
index bc671532edba8c2023f2945772a6e01ba6f419d7..c51a80830f17b1a00cb174c3d6711c0756e4432c 100644 (file)
@@ -1,4 +1,4 @@
-<para>GPSBabel supports the following Magellan receivers:
+<para>GPSBabel supports the following <ulink url="http://www.magellangps.com">Magellan</ulink> receivers:
 <simplelist columns="2">
        <member>310</member>
        <member>315</member>
index 2ee5fbf239b28c865564aeb327168c68f22297fc..88fd94eb2f68c691f51d17f090a1bb763ed5394c 100644 (file)
@@ -1,4 +1,4 @@
-<para>GPSBabel supports the following Magellan receivers:
+<para>GPSBabel supports the following <ulink url="http://www.magellangps.com">Magellan</ulink> receivers:
 <simplelist columns="2">
        <member>310</member>
        <member>315</member>
index be4fa14a9387e2dc4380e2234e53c29b96c082bc..b2f0e712fb4153e29b7770c3851055f1f18c57eb 100644 (file)
@@ -1,8 +1,8 @@
 <para>
-       This is the SD card format used by the Magellan Explorist 400,
+       This is the SD card format used by the <ulink url="http://www.magellangps.com">Magellan</ulink> Explorist 400,
        500, 600, and XL and internally on those devices plus the 
-       Explorist 210.  Waypoints are identical to the Magellan SD format 
-       used by Meridian, but allows longer waypoint names.  Routes are 
+       Explorist 210.  Storeed waypoints are identical to the Magellan SD format 
+       used by Meridian, but the newer models allow longer waypoint names.  Routes are 
        subtly different.
 </para>
 <para>         
index 506567d13a19a02f09d2247ec6ace1afe3538b00..ea97b5352995e7c16274d9e5f42a939ea400c6a7 100644 (file)
@@ -1,8 +1,8 @@
 
       
       
-      <para> The SD card format used by the Magellan Explorist 400,
-500, and 600 to describe geocaches.  Notice what while the format can
+      <para> The SD card format used by the <ulink url="http://www.magellangps.com">Magellan</ulink> > 400,
+500, 600, 210, and XL to describe geocaches.  Notice what while the format can
 hold an infinite number of geocaches, the unit will read and silently
 discard all but 200 geocache POIs at a time.</para>
       <para> You should name any file created with this format with a
index a06a0490ef2ee70e95b653f79a9f55a246ef687d..d2db2020f9874ca3094b28c7c1b4e84f0e6a6930 100644 (file)
@@ -1,5 +1,5 @@
 <para>
-Magellan NAV Companion for Palm/OS is not really designed
+<ulink url="http://www.magellangs.com">Magellan</ulink> NAV Companion for Palm/OS is not really designed
 for this sort of use, but its file format is supported and with a
 little bit of patience you can both read and write NAV Companion
 waypoints.  This conversion is based on
index 0dc62d68467f598a287dbfc9312f4f7057f0d132..a33cdc3bca97f7f02e25e8dd44e79d292c647757 100644 (file)
@@ -1,5 +1,5 @@
 <para>
-This format supports the Magellan <productname>MapSend</productname> native
+This format supports the <ulink url="http://www.magellangps.com">Magellan</ulink> <productname>MapSend</productname> native
 file format.
 </para>
 <para>
index 955f55e4c0b1b5480824acc9f024fc5e28211321..9bfc29a671f97b4773afa4102ce80a4bfcc31331 100644 (file)
@@ -34,3 +34,9 @@ that work with NMEA-0183 formatted data include:
   <ulink url="http://www.sparkfun.com/commerce/product_info.php?products_id=671">SparkFun GPS Datalogger</ulink>
 </member>
 </simplelist>  
+<para>
+This module also supports <link linkend="tracking">realtime tracking</link> 
+which allows realtime position reports from a GPS, such as one connected 
+serially, over Bluetooth, or a USB module emulating a serial port, to be used
+with selected output formats.
+</para>
index 679556531fff230441c2f0fd8fc0eeed1e8d2d12..f215467ff10d949a43dfeb2fffd6d22ebb220250 100644 (file)
@@ -1,5 +1,6 @@
       <para>The option 'datum="datum name"' can be used to override
 the default of NAD27 ("N. America 1927 mean") which is correct for the
-continental U.S. Points in Hawaii should use "Old
-Hawaiian_mean"</para>
+continental U.S.</para> <para>Any legal <link linkend="Datums">datum supported
+by GPSBabel</link> may be used.  For example, points in Hawaii should 
+use "Old Hawaiian_mean".</para>
     
index 428670cae4c2106e0808244ea2f45f0b63314e98..60abecec555d28daf2e8eaa3c5bfc2ae1b6e30ba 100644 (file)
@@ -5,9 +5,12 @@
 the lame NMEA six-character waypoint names that's treated as a
 second-class citizien in current versions of MapSource.  In Mapsource,
 use file-&gt;import to read these files.  If you name the files *.wpt,
-Mapsource will find them easier.
+Mapsource will find them more easily.
 </para>
       <para> In general, you should prefer the "mapsource" file format
 to this one.
 </para>
-    
+    <para>This format has been extended to handle many - but not all - 
+       files from <ulink url="http://www.gpsu.co.uk/index.html">GPS Utility</ulink>.  If you encounter something that GPSBabel does not handle well, use
+the free version of GPSUtil to read it and save as something more common.
+       </para>
index ce0e8cc26e5b2e3527e5dc8b8ede0bebd1de68a6..1b82e49c4c56e6c10782d411763f0b9d83ea0ce2 100644 (file)
@@ -1,8 +1,9 @@
 
       
       
-      <para> This is a format for importing into Microsoft Streets and
-Trips.  It's been exercised on versions 2003, 2004, and 2005. Detailed
+      <para> This is a format for importing into 
+<ulink url="http://www.microsoft.com/streets/default.mspx"> Microsoft Streets and
+Trips</ulink>.  It's been exercised on versions from 2003 through 2007. Detailed
 instructions on how to use it, including preserving hyperlinks, are at
 <ulink url="http://www.gpsbabel.org/formats/s_and_t/Importing_into_Microsoft_Streets_and_Trips_2003.html">gpsbabel.org</ulink>
          </para>
index 4073e0f27e9d3278dbe6a2e1a4ac60faf165769c..2c30a046d6aba462a914ef2f1960c29e14c0838e 100644 (file)
@@ -1,7 +1,7 @@
 
       
       
-      <para> This format is for Street Atlas USA 2004 Plus.
+      <para> This format is for Delorme Street Atlas USA 2004 Plus and later.
 </para>
       <para> For geocachers importing data from a tool like GSAK or
 Spinner, import the file twice in XData.  One will create a file with
index ee5457bd494d079820eed64e2e0767e000cd8f18..cf02509db1ce9dab2b8d57b7af197bdf77baaccb 100644 (file)
@@ -1,8 +1,8 @@
 
       
       
-      <para>TopoMapPro Places File.  Reads and writes places files for
-use in TopoMapPro <ulink url="http://www.topomappro.com">topomappro.com</ulink>).  As this file
+      <para>Reads and writes places files for
+use in <ulink url="http://www.topomappro.com">TopoMapPro places files</ulink>).  As this file
 type can store links other than web links, anything that is not a http
 url will be discarded.  Note that this does not do datum conversions,
 so if your input file does not have WGS84/NZGD2000 data, your output
index cb9b9472655628ab6beeeff4e901ac804c21f17e..5da5edc35d4b17decf162bb922ca9eb923a70aa3 100644 (file)
@@ -1,7 +1,7 @@
 
       
       
-      <para> This format can read and write TomTom .ov2 (POI) files,
+      <para> This format can read and write <ulink url="http://www.tomtom.com">TomTom</ulink> .ov2 (POI) files,
 as used by the TomTom GO and TomTom Navigator.  It has been tested
 with an original TomTom GO running version 5.00 of the TomTom
 software.  There may be some records that confuse the input module -
index 2032e560ba1863a7728c9386883965a627f71071..5d843e9dde62c9524087db8e1602e993e6a964fd 100644 (file)
@@ -1,8 +1,9 @@
 
       
       
-      <para>Delorme TopoUSA/XMap Conduit is one of the billion CSV
-variants mentioned above.  It's just like S&amp;A with the addition of
+      <para>Delorme TopoUSA/XMap Conduit is one of the bazillion 
+<link linkend="fmt_csv">CSV variants</link> 
+variants mentioned above.  It's just like Delorme Streets &amp; Atlas with the addition of
 a completely pointless line at the beginning and end of the file. This
 is the format used to hot-sync to XMap from withing TopoUSA. Done with
 help of Dan Edwards.</para>
index 06d59193757a5544a9edf7bc4bc14675ecce2ced..530403ef8e037f03a9e2892f35f316feebd65a40 100644 (file)
@@ -1,7 +1,9 @@
 
       
       
-      <para>Delorme XMap2006 Conduit is just like XMap, except there are 
+      <para>Delorme XMap2006 Conduit is just like 
+<link linkend="fmt_xmap">XMap</link> 
+, except there are 
        no spaces between fields and the coordinate format is slightly 
        different. The completely pointless header and footer lines 
        are the same, at least. Use this to create the XMapHHWptsSend.txt 
index cbd2481e11c71f765462975f7528f1d987353b4d..ba949bf00e4e3bb90ddef369299cdf132ae5ea70 100644 (file)
@@ -1,7 +1,7 @@
 <para>
 Delorme XMapHandHeld Street Atlas USA is another of the
-billion CSV variants.  This is the format used by XmapHH SA USA on (at
-least) PocketPC O/S. 
+billion <link linkend="fmt_csv"> CSV variants</link>.  
+This is the format used by XmapHH SA USA on (at least) PocketPC O/S. 
 </para>
 <para> 
 This XMap is not the same as the simpler